Mac100% 1998 November/MAC100-1998-11.ISO.7z/MAC100-1998-11.ISO/ｵﾝﾗｲﾝｿﾌﾄ定点観測/ﾃｷｽﾄ/QuoEdit042.sit/QuoEdit 0.42/Manual/QuoEdit042.man.j

Text File | 1998-08-23 | 31KB | 526 lines

/*/*/*/*/*/*/*/*/*/*/*/*/*/*/*/*/*/*/*/*/*/*/*/*/*/*/*/*/*/*/*/*

                    QuoEdit  version 0.42  (Japanese)

*/*/*/*/*/*/*/*/*/*/*/*/*/*/*/*/*/*/*/*/*/*/*/*/*/*/*/*/*/*/*/*/



QuoEdit（旧称QEdit）はSystem 7以降（漢字Talk 7.1以降）のMac OS上で動く単一スタイルのテキストエディタです。
QuoEditはAppleScript対応でもあります。AppleScriptやAppleイベント（Apple社の行事のことではありません）について分からない箇所は取り敢えず読み飛ばしてください。



●0　新仕様・変更点など
0.1　バージョン0.42の新仕様
0.1.1　grep検索
正規表現の検索ができるようになりました。2バイト文字対応です。（3.7参照）

0.1.2　Printダイアログボックス
Printダイアログボックスの内容をデフォルトとして設定できるように、編集中の書類が一つもない時でも開けられるようにしました。（2.1.9参照）
デフォルトのプリント情報に関するご報告を頂き、（プリンタドライバにもよると思いますが）プリントダイアログにも重要な項目が含まれていることを再認識できました。ご報告に感謝いたします。

0.2　前バージョンからの変更点
0.2.1　インテリジェントカット＆ペースト
若干改良しました。実行結果が以前と少し異なることがあり得ます。

0.3　バージョン0.42での修正点
0.3.1　ファイルダイアログボックスでの問題
バージョン0.41では、標準ファイルダイアログボックスを表示した際に動作が不安定になることがありました。（ご迷惑をおかけしました。）この問題は今回修正されました。

0.3.2　白黒表示でのショートカットガイド
画面が白黒表示の場合、ショートカットガイド中のキーが判別できませんでした（ご報告感謝！）。
今回色を調整（3ビットカラーに変更）することで、白黒に設定した時でも（当方では）きちんと見えるようになりました。もし白黒のオールドマックでまだ見づらい様でしたらどなたでもご連絡下さい。


●1　ファイル／フォルダ
1.1　QuoEdit
アプリケーション本体です。

1.2　QuoEdit Preferences（初期設定）
QuoEditはこのファイルの中に、新規書類の為の設定やアプリケーションの設定、プリントに関する情報、最近のファイルとフォルダの情報を保存します。

QuoEditが起動するとき、最初にQuoEditのフォルダからこのファイルを探します（バージョン0.4以降）。見つからない場合は起動ディスクのシステムフォルダの初期設定フォルダ内を探し、また見つからない場合はそのフォルダ内に新規に作ります。その為、通常は初期設定フォルダ内にあります。

もし複数の起動ディスクがあってそれぞれの起動ディスクから同じ条件で使いたい場合は（或いは単にわずかでも起動時間を縮めたい場合は）、この初期設定ファイルをQuoEditと同じフォルダに移動して下さい。もし初期設定フォルダに残っていたら捨てておきましょう。

QuoEditは起動時に一度このファイルを読み、終了時に全体の情報を書き直します。もし最近のファイルなどの新しい情報を記録したくない場合は、QuoEdit終了前にFinderでこのファイルを複写しておいて終了後に古い方に入れ替えるということができます。

1.3　QE Shortcuts
QuoEditのショートカットについてのApple Guide用のガイドファイルです。
Apple Guideが有効でない場合は、MiscellaneousフォルダのQE Shortcuts.txtというファイルで内容を見ることができます。

1.4　Scriptsフォルダ（エイリアスファイル可）
コンパイル済みのスクリプトを入れておく為のフォルダです。勿論自分でスクリプトを書いてこのフォルダに入れておくこともできます。これらのスクリプトはExecute Scriptコマンドから素早く選択実行できます。（Execute Scriptsについては2.5.2参照）

一方で、使わないスクリプトはこのフォルダから外してすっきりしましょう。例えばインターネットを使わない環境では“Get URL”は不要だったりします。

1.5　Applicationsフォルダ（エイリアスファイル可）
アプリケーションまたはそのエイリアスを置いておく為のフォルダです。何でも好きなものを置いて下さい。Launch Applicationコマンドから素早く起動できるようになります。（Launch Applicationについては2.5.6参照）

〔Save, QuoEdit! 〕
QuoEditに編集中の書類を定期的に保存させるアプレットです（初期設定で3分ごと）。QuoEdit終了後は自動的に終わるようになっています。
（拙作のアプレットやドロップレットについては、起動時にcontrolキーを押すことでコメントが見られます。）

1.6　Documentsフォルダ（エイリアスファイル可）
どんなファイルでも置いておけるフォルダです。頻繁に使うファイルまたはそのエイリアスを自由に入れて下さい。Let It Openコマンドから素早く開けるようになります。（Let It Openについては2.5.7参照）

〔My Scraps〕
漢字Talk 7.5以降用のスクラップブックの空のファイルです（それより古いOSでは開けません）。自由にお使い下さい。

1.7　Manualフォルダ
この文書のあるフォルダです。

1.8　Miscellaneousフォルダ（雑多なもの用フォルダ）
〔WrapIt〕
Appleイベントを通じてテキストを強制的に改行するアプリケーションです。Scriptsフォルダ内の“Wrap”というスクリプトからこれを使っていますが、他のスクリプティング対応プログラムとの組み合わせでも自由に使えます。

〔Remove Null Chars〕
QuoEditのバージョン0.31〜0.321では、韓国語用のパワーイムニョッキというインプットメソッドで入力するとスペースに続いてコードがゼロの文字（ヌルキャラクター）が入力されるという問題がありました。既にこの文字を含むテキストを作られた場合、このRemove Null Charsで取り除くことができます（お手数かけます）。


●2　メニューコマンド
SimpleTextやTeachTextなどを少しでもお使いでしたら基本的コマンドについてはお分かりのことと思います。多くの場合、和訳をもってそのメニュー項目の機能についての記述と致します。

2.0　Appleメニュー
2.0.1　About QuoEdit（QuoEditについて）
QuoEditのフォルダに“About QuoEdit”という名前のPICTファイル又はQuickTimeムービーファイル（又はそのエイリアス）があってメモリも充分な場合、その内容を表示します。最大サイズは幅400ピクセル×高さ300ピクセルです。
（但しムービーを作る予定は現時点でありません。ご希望でしたら独自にムービー又はピクチャーを用意して頂くことも可能です。そのような奇特な方はおられない？）

2.1　File（ファイル）
2.1.1　New（新規）

2.1.2　Open（開く）
通常通りファイルを開きます。加えてQuoEditはそのファイルとフォルダを最近開いたものとして記憶します。但しcontrolキーと一緒にOpenボタンを押した場合は記憶をしません。
（開き終わる時点でcontrolキーが押されている場合もそのファイルを記憶しません。これはFinderからファイルを開く時にも適用されます。）

ショートカットキーについて、cmd-Oとcmd-Iのタイプミスにご注意下さい。且つ、常に太枠ボタンの名前を確認されることをお勧めします。

2.1.3　Open Recents（最近開いたものを開く）
最近開いたファイル又はフォルダを開きます（複数可）。QuoEditは最後に開いたファイルとそのフォルダを各々8つまで、Mac OSが追跡できる間記憶します。
ショートカットキーはcmd-shift-Oです。

オープンボタンを押す際、optionキーの併用で目的の物をFinderに開かせ、option-shiftキーの併用で表示させることができます（Finderがスクリプティング対応の場合）。
一度覚えたものを忘れたい時は、目的のものを選んでcmd-deleteを押して下さい。
その他、ファイルリストでのshift + Openボタンも試してみて下さい。

2.1.4　Close（閉じる）
Optionキーを押しながら実行すると全ての書類を閉じます。

2.1.5　Save（保存）
Optionキーを押しながら実行すると全ての書類を保存します。

2.1.6　Save as（別名で保存）
ショートカットキーはcmd-shift-Sです。
ファイルを開く時同様、QuoEditは新しいファイルとそのフォルダを最近のものとして記憶します。但しcontrolキーと一緒に保存ボタンを押した場合は記憶をしません。

2.1.7　Revert（復帰）
ショートカットキーはcmd-shift-Rです。

2.1.8　Insert File（ファイル挿入）
Optionキーの併用でどのファイルのデータでも取り込めます（リソース部分ではなくデータ部分のみ）。

2.1.9　Page Setup（用紙設定）
ショートカットキーはcmd-shift-Pです。
このダイアログボックスで設定された内容は編集中の書類の属性となります。
書類を全て閉じてからこのコマンドを実行すると、デフォルトとして設定されます。一方でPrintダイアログの内容をデフォルトとして設定したい場合は、書類を全て閉じてからPrintコマンドの方を実行してみて下さい。

2.1.10　Print Options（印字オプション）
ショートカットキーはcmd-option-Pです。

2.1.11　Print（印字）

2.1.12　Quit（終了）

2.2　Edit（編集）
2.2.1　Undo（取り消し）
書類ごとに10回までの取り消し/やり直しが可能です。上限を増やす程メモリも消費されますが、Misc Appl Propsダイアログボックスで回数の上限を加減できます。

2.2.2　Redo（やり直し）
ショートカットキーはcmd-shift-Zです。

2.2.3　Cut（切取）
Optionキーの併用でスタイル付テキストとしてもカットできます。

2.2.4　Copy（複製）
Optionキーの併用でスタイル付テキストとしてもコピーできます。

2.2.5　Paste（貼込）

2.2.6　Clear（消去）

2.2.7　Select All（全てを選択）

2.2.8　Typeface（文字体裁）
フォント、サイズ、行送り、タブのピッチを設定します。
行送り（leading）の最小値として、フォントサイズと同じ値が指定できるようになっていますが、送りを小さくしすぎると適切に表示できないことがありますのでご注意下さい。

2.2.9　View（表示）
Viewダイアログボックスの設定は画面表示のみに反映します。例えばウィンドウは白黒反転や網かけができますが印刷結果は常に通常通りです。或いは改行文字の表示はそれを印字するかどうかには影響しません。

2.2.10　Misc Appl Props（アプリの属性あれこれ）
2.2.10.1　Auto Indent（オートインデント）

2.2.10.2　Intelligent Cut & Paste（インテリジェントカット＆ペースト）
このオプションがチェックされている場合、Cut、Paste、Clear、或いはドラッグアンドドロップを行う際、前後するスペースを自動的に調節します。
挿入されるテキストが255バイトを越える場合QuoEditはスペースを前後に加える処理をしませんのでご注意下さい。

通常の1バイトのスペース（20h）についてのみ処理します。QuoEditは日本語と中国語のテキストについてはなるべくスペースを加えないように努めますので、このオプションによる効果はあまり大きくありません。韓国語テキストについては1バイトのスペースで単語を区切る習慣上、日本語・中国語と処理方法を変えています。

2.2.10.3　Remember Selection（選択箇所記憶）
最終保存時の選択箇所を記憶するオプションです。

2.2.10.4　TSM aware（TSM対応）
もしお使いのインプットメソッドでインライン入力に問題がある場合は、このオプションをoffにしてみてください（ことえりで問題がないことは当方で日頃確認済）。
尚、QuoEditが扱うTSM（Text Services Manager）のサービスは現時点でインライン入力だけです。

2.2.10.5　Caret Speed（キャレット速度）
キーボードコントロールパネルで最速に設定しても物足りない場合に使ってみて下さい。但し古いCPUでは効果はないようです。その場合はノーマルに戻して下さい（ダイアログボックス上でcmd-1）。

2.2.10.6　Undo Levels（やり直しの回数）
取り敢えず1〜10回までで指定できるようにしています。

2.3　Search（検索関連）
2.3.1　Find（検索）

2.3.2　Find Backward Again（後方再検索）

2.3.3　Find Forward Again（前方再検索）
Shiftキーを押しながら行うと、選択範囲を現在位置から拡大します。同様のことは他のコマンドにも適用されます。
Optionキーを押しながら行うと、目的の文字列を選択しません。同様のことは他の検索コマンドにも適用されます。

2.3.4　Enter Selection（選択範囲取込）
選択範囲を検索文字列として取り込みます。Optionキーの併用で置換文字列として取り込みます。

2.3.5　Replace（置換）

2.3.6　Replace & Find Next（置換及び次検索）

2.3.7　Replace All（全置換）

2.3.8　Jump To（移動）

2.4　Windows（窓）
2.4.1　Window Size（窓サイズ）
ウィンドウのサイズは勿論サイズボックスをドラッグすることで変更できるのですが、このダイアログボックスでは特殊なサイズも指定できます。よかったら -1 あるいは他のマイナスの数値を試して下さい。

2.4.2　Arrange（整列）
ディスプレイの左上の混雑を避けるべく、新しいウィンドウの位置を変えられます。
ウィンドウを並べ直すと同時にWindowsメニューのショートカットキーも整理します。
Arrangeボタンを押す時、Optionキーの併用で上に積み上げ、shiftキーの併用で下方向に積みます。

2.4.3　Previous（前）
Windowsメニューの中で一つ前のウィンドウがあれば選択します。

2.4.4　Next（次）
Windowsメニューの中で次のウィンドウがあれば選択します。

2.4.5　ウィンドウのリスト
書類が新しく作られるか開かれる際にメニューの最下段に名前が追加され、閉じる際に除去されます。一度閉じて再度開かない限り順番が入れ替わることはありません。

現在の書類の名前は太い字体で表示されます。また、テキストの内容に変更がある書類の名前には菱形のマークが付加されます。

2.5　Extras（付加価値機能）
2.5.1　Last Script（直前のスクリプト）
Execute Scriptで（或いはdo scriptイベントで）最後に選択実行したスクリプトを再度実行します。
ショートカットキーはcmd-shift-Uです。

2.5.2　Execute Script（スクリプト実行）
QuoEditのフォルダの“Scripts”フォルダ（又はその他のフォルダ）にあるスクリプトファイルを選択実行します。

スクリプトをファイルから読み込んだ後、QuoEditはそのスクリプトデータを最後のスクリプトとしてメモリに一時保存し、繰り返し実行可能になります。但しcontrolキーと一緒に実行ボタンを押した場合はメモリ保存をしません。（いずれにしても、元のファイルについての情報は何も記憶しません。）

オプションキーと一緒にボタンを押すことでスクリプトファイルを開くこともできます。

2.5.3　Record Sequence／Stop Recording（操作の記録／停止）
一連の操作をスクリプトとして記録します。
ショートカットキーはcmd-option-Bです（BはkeyBoardマクロに由来）。
（「AppleScript版キーボードマクロ」と理解して構いませんが、正式にはキーボードマクロとは区別します。実際アップルのスクリプティングアーキテクチャに大きく依存し、スクリプト記録対応の他のソフトでの操作も記録します。）

QuoEditは、キーボードの操作は現在の位置に対して相対的な動きとして記録しますが、マウスのクリックは絶対的な位置で記録しますのでご注意下さい。
ダイアログボックスでの操作については、その結果のみが記録されます。

最初にこの機能を使う時は、AppleScriptの機能が起動するのに時間がかかりますのでご注意下さい。

あと、漢字Talk 7.1でAppleScriptを使われている方は“インラインフィルタ”のインストールをお忘れなく。

2.5.4　Run Sequence（操作の再生）
スクリプトとして記録された一連の操作を再生します。

2.5.5　Save Sequence（操作の保存）
記録された一連の操作をスクリプトファイルに保存します。
ショートカットキーはcmd-shift-Bです。

しばらく頻繁に実行する予定でしたら、デフォルトのフォルダに次の形式で名前をつけてみて下さい。
    ~a    ~b    ~8    ~3        など
Scriptsフォルダにあるこの形式の名前のスクリプトは、cmd-ctrlショートカットキーで実行できます。例えば、 cmd-ctrl-Eで“~e”という名前のスクリプトを実行できます。
これは他のスクリプトファイルにも適用されます。例えば、頻繁に使うスクリプトファイルのエイリアスを上記の形式の名前で作ってみて下さい。
（いずれはcmd-ctrlショートカットの為のカスタマイズ可能なテーブルを用意できればと考えています。）

さて、これでスクリプト編集プログラムなしでもスクリプトを扱えるようになりました。しかしながら、操作がどのように記録されるのかを理解しておくことは無益なことではありません。直ちにそのスクリプトを読んだり編集したりする場合は、Saveボタンを押す際にoptionキーを一緒に押してみて下さい。

2.5.6　Launch Application（アプリケーション起動）
QuoEditのフォルダの“Applications”フォルダ（又はその他のフォルダ）にある任意のアプリケーションを実行します。

2.5.7　Let It Open（開かせる）
QuoEditのフォルダの“Documents”フォルダ（又はその他のフォルダ）にある任意のファイルを開く依頼をFinderにします。
ショートカットキーはcmd-shift-Lです。
（Finderがスクリプティング非対応バージョンの場合、このメニュー項目は実行不可になります。）

2.5.8　Speak／Stop Speaking（読み上げ／読み上げ中止）
スピーチマネージャーがシステムに組み込まれていれば、このコマンドが有効になり、QuoEditはコンピュータに喋らせることができます。但しスピーチマネージャーがサポートする言語だけです。
QuoEditはテキストのコピーをスピーチマネージャーに一度渡すだけですので、コンピュータが喋っている間はテキストの編集など自由です。

日本語Text-To-Speech（J-1.1）については仮名は読み上げ可能ですが仮名漢字混じりの文については未対応です。AppleScript経由でOSに喋らせることは可能かもしれませんが、仮名漢字混じりについてはPowerPCでなくてはできないとのことで未確認です。また、日本語Text-To-Speechは（少なくとも68Kでは）英語が喋れないようです。英語スピーチにはEnglish Text-To-Speechが当面お勧めということでしょうか。

2.5.9　Pause Speaking／Continue Speaking（読み上げの一時休止／継続）
ショートカットキーはcmd-option-Kです。


●3　全般的事項
3.1　データサイズ
QuoEditが扱えるデータ量は、主にコンピュータに装備されているメモリに依存します。但し、カット／コピー／ペースト／ファイル挿入／ドロップができるデータ量は依然アプリケーションメモリに依存します。これらのことを大きなデータで行う場合は、Finderの“情報を見る”で使用サイズを増やしてみて下さい。

3.2　書類ごとの属性
Set Defaultボタンのある全てのダイアログボックスの設定は書類ごとの属性になり、それぞれの（QuoEditでつくられた）ファイルにリソースとして保存されます。例えば、Print Optionsダイアログボックスの改行文字を印字するかどうかは書類ごとの属性になります（特殊文字の印字は校正が必要な書類には有用な場合があります）。

Set Defaultボタンはダイアログボックスの内容を以後作られる新規書類の初期設定として直ちに設定します（この初期設定はアプリケーションの属性として扱われます）。

Page Setupダイアログボックスで設定された内容も書類ごとの属性になりますが、この情報（現時点一般的に120バイト）をファイルに保存するかどうかはPrint Optionsダイアログボックスで選択できます。（バージョン0.1番台と0.2番台では常に保存していました。）

3.3　ショートカットキー
3.3.1　アピアランスマネージャー対応メニュー表示
アピアランスマネージャーが組み込まれている場合、optionキーやshiftキー併用のショートカットがメニューに表示されます。
ところで、QuoEditには全部のメニューコマンドにキー割り当てがあります。アップルのガイドラインでは「頻繁に使うコマンドにだけキーを割り当てなさい」とのことですが、私の場合全部頻繁に使うんです、ということでご容赦下さい。

3.3.2　矢印キーの動き
Appleのガイドラインが示す通り、
    矢印キー　→　optionキー＋矢印キー　→　cmdキー＋矢印キー
の順にその動きを拡大します。

3.3.3　ショートカットのガイド
Apple Guideがシステムに組み込まれていてQE ShortcutsというファイルがQuoEditと同じフォルダにあれば、ヘルプ（ガイド）メニューからショートカットのガイドが見られます。

3.4　Finderの利用（Finderがスクリプティング対応の場合）
QuoEditのいくつかの標準ファイルダイアログボックスから、optionキー＋デフォルトのボタンで、Finderに目的のファイルを開かせることができます。（Open、Insert File、Execute Script、Save Sequenceで可能。）このことはOpen Recentsのダイアログボックスにも適用されます。

また、QuoEditの多くの標準ファイルダイアログボックスから、option-shiftキー＋デフォルトのボタンで、Finderに目的のファイルを表示させることができます。このことはOpen Recentsのダイアログボックスにも適用されます。

（但しエイリアスファイルを選択してoptionキーを押さえている時は、標準ファイルダイアログのなすべきことが優先されます。）

上記のことは、FinderにAppleイベントで依頼を送ることで実現しています。

3.5　ドラッグアンドドロップ
書類ウィンドウやFindダイアログボックスでドラッグアンドドロップができます。テキストファイルのドロップも可です。

ドラッグアンドドロップの仕様は他のアプリケーションと同様規定通りです。それに加えて、ドラッグ開始時にoptionキーが押され且つアプリケーションの外にドラッグする場合、QuoEditはスタイル付テキストとして出力します。文字コード体系がOSと異なる外国語などを扱うのに良いと思います。

3.6　ウィンドウ位置の記録
書類のウィンドウが一度マウスまたはAppleイベントで移動された場合、保存時にその位置を記録します。
但し、Arrangeコマンドにより整列された後は、ユーザーによって動かされていないものとみなし記録はしません。
（ズームされた状態での保存はお勧めしません。このサイズと位置をどう保存するかは今後の課題としておきます。）

3.7　正規表現（grep）
初歩的なレベルですが、2バイト（全角）文字対応の正規表現の検索ができます。
次のメタ文字が検索文字列に使用可能です（置換文字列では使えません）。
正規表現中に改行文字を含めることはできませんのでご注意下さい。

    ^    行頭一致
            ^¥t        段落の頭にあるタブ
    $    行末一致
            )$        段落の最後にある“)”
    .    改行文字以外の一文字
    ?    直前のパターンがゼロまたは一つ
    *    直前のパターンがゼロまたは一つ以上
    +    直前のパターンが一つ以上
    [s]    ブラケット中のどれかの文字
            [abc]    a、b、c
            [a-z]    a、b、c、 ...... x、y、z
    [^s]    ブラケット中にないどれかの文字
            [^0-9a-zA-Z]    英数以外の文字なら何でも
    ¥    エスケープシーケンス（日本語フォント以外ではバックスラッシュ）
            ¥b        バックスペース（¥x08）
            ¥e        エスケープ（¥x1B）
            ¥f        フォームフィード（¥x0C）
            ¥n        ラインフィード（¥x0A）
            ¥r        キャリッジリターン（¥x0D）
            ¥s        スペース（¥x20）
            ¥t        タブ（¥x09）
            ¥xDD    16進数文字コード（1〜4桁）
            ¥^C        コントロール文字
            ¥C        その他：その文字自身

3.8　左←右方向の言語
WorldScript Iを含む該当するスクリプトシステムが組み込まれていればQuoEditでアラブ語やヘブル語のような左←右方向のテキストを編集できます。但し、双方向の言葉を含まない（例えばアラブ文字の文脈に英単語が含まれない）という条件付きです。
システムの文字方向が左←右である場合は、双方向のテキスト編集も問題ないようですが、画面上での選択範囲は常に続いているようにしか表示されないという制約はあります。
ヘブル文字、アラブ文字のフォントを使った書類の行揃えについて、QuoEditはシステムの文字方向に関わらず、現時点では右揃え固定にしています。

3.9　色
ウィンドウヘッダの色が日々変わっていることにある日気付いたとしても、どうか落ち着いて下さい。単なるQuoEditの仕様です。4月1日が始点になってます。

3.10　Quoとは？
　q：速い（quick）操作（希望）
　u：分かりやすい（understandable）シンプルな仕様（ややこじつけ的希望）
　o：OSA（Open Scripting Architecture）対応

他に、ラテン語で「どこへ」「どこまで(どれ程)」などの意味があります。


●4　AppleScript／Appleイベントに関する事柄
4.1　AppleScript対応
AppleScriptとは、様々な仕事を自動化することができるとても便利なものです。QuoEditはAppleScript対応で、ドラッグアンドドロップ以外の殆どの操作についてスクリプトを書いたり記録することができます。

尚、AppleScriptそのものについては関連書籍等にお任せするとして、ここでは記述しません。

4.2　紛らわしい言葉
4.2.1　「コマンド」「イベント」
AppleScriptの「コマンド」については、アプリケーションのメニューコマンドと区別する為、この文書ではAppleイベントの観点から「イベント」と表現しています。

4.2.2　「スクリプト」
「スクリプト」という言葉にはMac OSでは2通りの意味があります。
(1) 言語（language）の総称。例えばローマンスクリプトというと英語、ドイツ語、フランス語などが該当し、日本語スクリプトというと日本語しか該当しなかったりもします。ここで取り上げるスクリプトは勿論この意味ではありません。
(2) ユーザーが書くことのできる実行可能なプログラム又はそのプログラムの素になる命令を記述したテキスト。特にここではAppleScriptの様式で書かれたスクリプトのことを意味します。
と言うことで、「スクリプト」の意味について混乱しませんように。言葉の前後関係で区別できると思います。

4.2.3　「AppleScript」
AppleScriptとは、Apple Computer社のオープンスクリプティングアーキテクチャ（OSA）をサポートする所のスクリプティングコンポーネントの一つです。ですから、この文書中で単に「AppleScript」と書かれていても「AppleScript又はその他のスクリプティングコンポーネント」のように理解することが可能です。（QuoEditの動作テストは実際にはAppleScriptでのみ行っています。）

4.3　用語
QuoEditの用語は英語表現形式を前提に作られていますので、スクリプトを開いたり書いたりされる場合は必ずスクリプト編集プログラムで英語表現に設定した上で行ってください。
扱うイベントやクラスについては、スクリプト編集プログラムの“用語説明を開く”コマンドでQuoEditを選択するか、又はQuoEditのアイコンをスクリプト編集プログラムのアイコンにドラッグすることでも参照できます。頻繁に参照される方は次のスクリプトをお試し下さい。

    tell application "スクリプト編集プログラム"
        launch
        activate
        open ((path to application "QuoEdit") as alias)
    end tell

4.4　AppleScriptの制約
AppleScriptが扱えるテキストの大きさは30000バイトまで(*)と学んだことがあります（Apple Computerの何かの資料で読みましたがどの資料だったかは不明）。
但し、二つのプログラム（例えばQuoEditとAppleScript）が直接テキストそのものを送受信しない場合はこの制約を受けません。クリップボードやファイル経由でテキストをやりとりする場合も勿論この制約は受けません。

例えば、大量のテキストを選択して次のような文を含むスクリプトを実行すると、メモリエラーが返されるか、システムエラーを起こすこともあり得ます。
    if selection as text is not "" then
この問題は次のように置き換えることで避けられます。
    if 0 < length of selection then

(*) 実際にはAppleScriptのエラーメッセージでは最大32KB（＝32×1024＝32768バイト？、因みにTextEditの制限は32KBではなく32000バイト）までと表示されますが、現在QuoEdit添付のスクリプトでは安全の為30000バイトまでに制限しています。もし32000バイトまで大丈夫ようであれば変えて頂いて構いません。

4.5　Transliterate（文字の変換）
このイベントが送られてきた場合、QuoEditは単にその命令を翻訳してMac OSのTransliterateTextと呼ばれるツールボックスルーチンに伝え、その結果を指示された元のテキストと置き換えるということをします。

このTransliterateTextが扱える最大のデータ量については、2バイト整数の最大値、65535バイトのようです（数値は実際にいろいろ試した結果）。

1バイト←→2バイトの変換結果が現在完璧でありませんが、TransliterateTextルーチンが使うところのリソースの問題と思われます。この件についてはApple Computerさんにぜひ改善のお願いをしてみて下さい。

4.6　Cut／Copy／Paste
QuoEditがバックグランドの場合cut、copy、pasteが正常にできないことがありますので、スクリプトでこれらのことをさせる場合はactivateさせた上で行って下さい。QuoEditはこの件については敢えてエラーメッセージを出しませんのでご注意下さい。

4.7　Do copyイベント
AppleScriptがコンパイル時にcopyイベントのパラメータを受け付けない場合、“do copy”を使ってみて下さい。（コンパイル済みのスクリプトでは問題ありません。問題はコンパイル又は再コンパイルする時です。）

QuoEditはcopyとcutイベントにオプションパラメータを追加していて、cutについては大丈夫なのですが、copyについてAppleScript（バージョン1.1）はこのパラメータを受け付けようとしません。Copyは、多くのアプリケーションが扱うイベントであると同時にAppleScript標準のコマンドでもあり、その為AppleScriptが他のイベントとは違う方法で解釈しようとするのかもしれません。
尚、“do copy”はAppleScriptをだますための“copy”の単なる偽名です。

4.8　Cut／Copyイベントのignoring nurseパラメータ
操作の記録中、QuoEditはcutとcopyに対してこのパラメータを加えます。“nurse”は“no-user-selection error”の略（もじり）です。

通常は、何も選択せずにcutやcopyをしようとするとno-user-selectionエラー、つまり「何も選択されていませんよ」というエラーが返されることに決まっています。
例えば、タブで区切られたデータを扱っていて中に空のフィールドが所どころあるときなど、このエラーを無視することが役に立つでしょう。

4.9　特定のインデックスを伴うインデックス参照
4.9.1　Documentクラスに属するfileクラス
インデックスとして、1のみが有効です。
    file 1 of document 1 of application "QuoEdit"

4.9.2　Applicationクラスに属するscriptクラス
インデックスとして、-1、last、1、first のみが有効です。
-1又は“last”は、Execute Scriptで最後に実行されたスクリプトを意味します。
    last script of application "QuoEdit"
1又は“first”は現在Record Sequenceで記録されているスクリプトを意味します。
    script 1 of application "QuoEdit"

4.9.3　Applicationクラスに属するfileクラス／folderクラス
インデックスとして、マイナスの数値又は“last”のみが有効です。これは最近のファイルやフォルダへの参照を意味します。
    tell application "QuoEdit" to open last file
    tell application "QuoEdit" to get folder -1

4.10　フォルダ内のオブジェクトに対する名前参照
QuoEditのフォルダ内のファイル又はフォルダに対して簡単な参照方法を用意しています（バージョン0.4以降）。クラスは file か folder のいずれかで、あとはファイル名かフォルダ名だけで参照できます。
    tell application "QuoEdit" to get folder "Scripts"
（クラス、コンテナクラス共に4.9.3の例と同じですが、意味は全く異なることに注意して下さい。最近のファイルとフォルダの為に新しいクラスを定義することを避けたかったのです。）

“Scripts”“Applications”“Documents”の各フォルダは同名のエイリアスファイルであり得ますので、file又はfolderのクラスを注意して指定する必要があります。

4.11　Choose one fileイベント
“choose one file”とは標準のスクリプティング機能追加にある“choose file”の真似っ子、もとい、補完しようとするものです。オリジナルの方は表示するフォルダ（又はファイル）を指定できないのでQuoEditに追加しました。特定のフォルダでファイルを選ぶには、例えば次のように指定します。

    choose one file of type {"TEXT"} at alias "DiskName:jgawk:scripts:"

又、このダイアログボックスでも、optionキー＋デフォルトボタンでFinderに目的のファイルを開かせます。或いはoption-shift＋デフォルトボタンでそのファイルを表示させます。これらの場合QuoEditはエラーコードの-128（ユーザーキャンセルエラー、つまりキャンセルボタンが押されたのと同意）を返します。

4.12　Openイベントについて
QuoEditは最近開いたファイルとそのフォルダを通常覚えるようになりましたが（バージョン0.4以降）、それはopenイベントを受け取った際も同様です。
しかし、QuoEditにファイルを開かせるスクリプトを何か今までに書かれたとすると、開くこと自体は自動化されているはずですので、そのファイルを覚えておく必要のない場合が多いのではないでしょうか。そのような場合、openの命令に対して“without remembering”をパラメータとして追加しておくことをお勧めします。

4.13　Do scriptイベントについて
Do script文を書く場合、複雑さを避ける為に“without memory keeping”（メモリ保存しない）をパラメータとして付け加えておかれることをお勧めします。
操作記録中にExecute Scriptを実行された時はQuoEditは自動的にこのパラメータを追加します（バージョン0.4以降）。


●5　環境
5.1　必要なシステム
Mac OSはシステム7以降又は漢字Talk 7.1以降である必要があり、これは必須です。（System 7.0での動作は実際には未確認です。）

以下は必ずしも全部が必須ではありません。任意です。

［AppleScript］
Extrasメニューの多くのコマンドを実行するにはAppleScriptがインストールされている必要があります。漢字Talk 7.1にはAppleScriptやスクリプティング機能追加が本来含まれていませんので、入手して組み込む必要があります。漢字Talk 7.5以降を標準の状態で使われている場合は、既にAppleScriptが使える状態になっています。

［スクリプティング対応のFinder］
多くの状況で、QuoEditはファイル（稀にフォルダ）を開いたり表示したりする命令をFinderに送ることができますが、その為にはFinderがスクリプティング対応である必要があります。（AppleScriptは組み込まれていなくても可です。）
System（漢字Talk）7.1については、Finderのバージョンが7.1の場合スクリプティング未対応ですが、Finderの7.1.3と“ファインダースクリプティング機能拡張”の組み合わせでスクリプティング対応になります（7.1.2も多分大丈夫？）。OSのバージョンが7.5以降については標準で対応しています。

［Macintosh ドラッグ & ドロップ］
漢字Talk 7.1の場合、ドラッグアンドドロップをする為にはMacintoshドラッグ&ドロップを可能にする機能拡張が必要です。

［スピーチマネージャー］
スピーチの機能を使うには、Speech Managerが必要です。（主に英語版のバージョン1.3から1.5で動作確認しています。）

［アピアランスマネージャー］
Shiftキーやoptionキーを伴うショートカットキーの割り当てをメニューに表示するにはアピアランスマネージャーが組み込まれている必要があります。Mac OS 8以降では標準で実装されています。
但しこれが無くてもQuoEditは同様に処理をしますので、ショートカットキーを使う分には影響はありません。

［Apple Guide］
ヘルプメニュー（ガイドメニュー）からショートカットについてガイドを見るにはApple Guideがインストールされている必要があります。漢字Talk 7.5以降では標準で組み込まれています。

5.2　開発環境
QuoEditのこのバージョンの開発とテストは主に又は専ら以下の設備で行いました。

    コンピュータ：Macintosh LC475（33MHz FPU付に改造；改造は自己責任で）
    ＯＳ：System 7.5.1、7.1、Mac OS 7.6.1、8.1 (＋ いくつかのLanguage Kit)
    開発ツール：Symantec C++ version 7.0（C言語）
    　　　　　　Guide Maker 1.4b3
    プリンタ：PC-PR1000EW　NEC
    プリンタドライバ：MacPrint Pages ver.1.0.1　関西電機


●6　配布等
QuoEdit 0.42はフリーウェアで、知人友人等に無料配布OKです。
QuoEditに対する著作件等の権利は作者の酒井遼明が保有します。
付属のスクリプトについても同様ですが、これについては権利にこだわるものではありません。ユーザーの責任において再利用して頂ければ良いと考えます。
QuoEditの使用結果に対して作者は責任を負いません。とはいえバグの報告などは大歓迎です。


●7　最後に
QuoEditの改善に役立つ報告や貴重なアドバイスを寄せて頂いた方々に心よりお礼申し上げます。
QuoEditのフランス語版への翻訳を申し出て頂いたAlain Antinoriさんには特別にお礼申し上げます。
他にもご意見、ご感想などメッセージを頂きました。どうもありがとうございました。



平成10年8月
酒井遼明
E-mail：[e-mail] ／ [e-mail]

（[e-mail]は平成10年4月より無効になっていますのでご注意）